Inside Macintosh: QuickDraw GX Printing Extensions and Drivers /

Chapter 5 - Printing Functions for Message Overrides / Printing Functions Reference

Functions / Working With Application Imaging Options

GXSetPreferredJobFormatMode

You can use the GXSetPreferredJobFormatMode function to define, for the application , which job format mode is the preferred mode for your printer driver.

OSErr GXSetPreferredJobFormatMode (gxJobFormatMode mode,
                                   Boolean directOnly);

mode

The job format mode that your driver prefers.

directOnly

A Boolean value that is true if your driver only supports text mode and false if not.

function result

An error code. The value noErr indicates that the operation was successful.

DESCRIPTION

The GXSetPreferredJobFormatMode function establishes which of the job format modes is the preferred mode of a printer driver. If a printer driver supports PostScript, it generally sets gxPostscriptJobFormatMode as its preferred mode. If a driver only supports the use of built-in text fonts, it sets gxTextJobFormatMode as its preferred mode. Otherwise, a printer driver generally sets gxGraphicsJobFormatMode as its preferred mode.

You set the directOnly value to true if your printer driver does not support graphics mode. For instance, this is the case for a daisy-wheel printer. In this case, you communicate to the application that it cannot send graphics to be printed by your driver by setting the directOnly value to true.

RESULT CODES

gxSegmentLoadFailedErr	A required code segment could not be found, or there was not enough memory to load it.
gxPrUserAbortErr	The user has canceled printing.

SEE ALSO

You can find an example of using the GXSetPreferredJobFormatMode function in Listing 3-7 on page 3-29 in the chapter "Printer Drivers."

The job format mode constants are described on page 5-14.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help